HAL QSPI types migration

This section provides information about the HAL QSPI types migration.

HAL QSPI callback ID type definition

HAL1

HAL2 

typedef enum
{
  HAL_QSPI_ERROR_CB_ID,
  HAL_QSPI_ABORT_CB_ID,
  HAL_QSPI_FIFO_THRESHOLD_CB_ID,
  HAL_QSPI_CMD_CPLT_CB_ID,
  HAL_QSPI_RX_CPLT_CB_ID,
  HAL_QSPI_TX_CPLT_CB_ID,
  HAL_QSPI_RX_HALF_CPLT_CB_ID,
  HAL_QSPI_TX_HALF_CPLT_CB_ID,
  HAL_QSPI_STATUS_MATCH_CB_ID,
  HAL_QSPI_TIMEOUT_CB_ID,
  HAL_QSPI_MSP_INIT_CB_ID,
  HAL_QSPI_MSP_DEINIT_CB_ID
}HAL_QSPI_CallbackIDTypeDef;

  • Removed from HAL2 : the callback registration is managed by dedicated functions for each QSPI event. For more details, see : HAL QSPI register callback

  • HAL_QSPI_MSP_INIT_CB_ID and HAL_QSPI_MSP_DEINIT_CB_ID are removed because the functions HAL_QSPI_MspInit() and HAL_QSPI_MspDeInit() are removed.

Related concepts:

HAL QSPI state type definition

HAL1

HAL2 

typedef enum
{
  HAL_QSPI_STATE_RESET,
  HAL_QSPI_STATE_READY,
  HAL_QSPI_STATE_BUSY,
  HAL_QSPI_STATE_BUSY_INDIRECT_TX,
  HAL_QSPI_STATE_BUSY_INDIRECT_RX,
  HAL_QSPI_STATE_BUSY_MEM_MAPPED,
  HAL_QSPI_STATE_ABORT,
  HAL_QSPI_STATE_BUSY_AUTO_POLLING,
  HAL_QSPI_STATE_ERROR
}HAL_QSPI_StateTypeDef;

typedef enum
{
  HAL_XSPI_STATE_RESET,
  HAL_XSPI_STATE_INIT,
  HAL_XSPI_STATE_IDLE,
  HAL_XSPI_STATE_TX_ACTIVE,
  HAL_XSPI_STATE_RX_ACTIVE,
  HAL_XSPI_STATE_MEMORY_MAPPED_ACTIVE,
  HAL_XSPI_STATE_ABORT,
  HAL_XSPI_STATE_AUTO_POLLING_ACTIVE,

  HAL_XSPI_OTFDEC_STATE_ENCRYPT,
  HAL_XSPI_STATE_CMD_ACTIVE
} hal_xspi_state_t;

Related concepts:

HAL QSPI auto-polling type definition

HAL1

HAL2 

typedef struct
{
  uint32_t Match;
  uint32_t Mask;
  uint32_t Interval;
  uint32_t StatusBytesSize;
  uint32_t MatchMode;
  uint32_t AutomaticStop;
}QSPI_AutoPollingTypeDef;

typedef struct
{
uint32_t match_value;
uint32_t match_mask;
uint32_t interval_cycle;
/* */
hal_xspi_match_mode_t match_mode;
hal_xspi_automatic_stop_status_t automatic_stop_stat
}hal_xspi_auto_polling_config_t;

Related concept: Replaced TypeDef suffix with _t in type names

HAL QSPI command type definition

HAL1

HAL2 

typedef struct
{
  uint32_t Instruction;
  uint32_t Address;
  uint32_t AlternateBytes;
  uint32_t AddressSize;
  uint32_t AlternateBytesSize;
  uint32_t DummyCycles;
  uint32_t InstructionMode;
  uint32_t AddressMode;
  uint32_t AlternateByteMode;
  uint32_t DataMode;












  uint32_t NbData;
  uint32_t DdrMode;
  uint32_t DdrHoldHalfCycle;

  uint32_t SIOOMode;
}QSPI_CommandTypeDef;

typedef struct
{
  uint32_t instruction;
  uint32_t addr;
  uint32_t alternate_bytes;
  uint32_t size_byte;
  hal_xspi_alternate_bytes_width_t alternate_bytes_width;
  uint32_t dummy_cycle;
  hal_xspi_instruction_mode_t instruction_mode;
  hal_xspi_addr_mode_t addr_mode;
  hal_xspi_alternate_bytes_mode_t alternate_bytes_mode;
  hal_xspi_regular_data_mode_t data_mode;

  hal_xspi_addr_width_t addr_width;
  hal_xspi_operation_type_t operation_type;
  hal_xspi_io_select_t  io_select;
  hal_xspi_instruction_width_t instruction_width;
  hal_xspi_instruction_dtr_status_t instruction_dtr_mode_status;
  hal_xspi_addr_dtr_status_t addr_dtr_mode_status;
  hal_xspi_alternate_bytes_dtr_status_t alternate_bytes_dtr_mode_status;
  hal_xspi_data_dtr_status_t data_dtr_mode_status;
  hal_xspi_dqs_status_t dqs_mode_status;
} hal_xspi_regular_cmd_t;





 HAL_XSPI_EnableSIOO(hal_xspi_handle_t *hxspi);
 HAL_XSPI_DisableSIOO(hal_xspi_handle_t *hxspi);

HAL QSPI handle type definition

HAL1

HAL2 

QSPI_HandleTypeDef

hal_xspi_handle_t

Related concepts:

HAL QSPI initialization type definition

HAL1

HAL2 

typedef struct
{
  uint32_t ClockPrescaler;
  uint32_t SampleShifting;
  uint32_t FifoThreshold;
  uint32_t FlashSize;
  uint32_t ChipSelectHighTime;
  uint32_t ClockMode;
  uint32_t FlashID;
  uint32_t DualFlash;
}QSPI_InitTypeDef;

typedef struct
{
  uint32_t clk_prescaler;
  hal_xspi_sample_shift_t shift;
  hal_xspi_delay_hold_t hold;
  uint32_t cs_high_time_cycle;
  uint32_t cs_refresh_time_cycle;
  hal_xspi_dlyb_state_t dlyb_state;
} hal_xspi_timing_config_t;

Related concept: Replaced TypeDef suffix with _t in type names

HAL QSPI memory mapped type definition

HAL1

HAL2 

typedef struct
{
 uint32_t TimeOutPeriod;
 uint32_t TimeOutActivation;
}QSPI_MemoryMappedTypeDef;

typedef struct
{
 uint32_t timeout_period_cycle;
 hal_xspi_timeout_activation_t timeout_activation;
} hal_xspi_memory_mapped_config_t;

Related concept: Replaced TypeDef suffix with _t in type names

HAL QSPI callback type definition

HAL1

HAL2 

pQSPI_CallbackTypeDef

hal_xspi_cb_t